home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2003 August / MW 8 2003 CD1.iso / Inside Macworld / Product News / gimp-1.2.4.sit / gimp-1.2.4 / devel-docs / libgimp / sgml / gimppaths.sgml < prev    next >
Encoding:
Text File  |  2003-05-20  |  22.2 KB  |  451 lines
  1. <refentry id="libgimp-gimppaths" revision="19 Jan 2001">
  2. <refmeta>
  3. <refentrytitle>gimppaths</refentrytitle>
  4. <manvolnum>3</manvolnum>
  5. <refmiscinfo>LIBGIMP Library</refmiscinfo>
  6. </refmeta>
  7.  
  8. <refnamediv>
  9. <refname>gimppaths</refname><refpurpose></refpurpose>
  10. </refnamediv>
  11.  
  12. <refsynopsisdiv><title>Synopsis</title>
  13. <synopsis>
  14.  
  15.  
  16.  
  17. <link linkend="gchar">gchar</link>**     <link linkend="gimp-path-list">gimp_path_list</link>                  (<link linkend="gint32">gint32</link> image_ID,
  18.                                              <link linkend="gint">gint</link> *num_paths);
  19. <link linkend="gint">gint</link>        <link linkend="gimp-path-get-points">gimp_path_get_points</link>            (<link linkend="gint32">gint32</link> image_ID,
  20.                                              <link linkend="gchar">gchar</link> *pathname,
  21.                                              <link linkend="gint">gint</link> *path_closed,
  22.                                              <link linkend="gint">gint</link> *num_path_point_details,
  23.                                              <link linkend="gdouble">gdouble</link> **points_pairs);
  24. <link linkend="gchar">gchar</link>*      <link linkend="gimp-path-get-current">gimp_path_get_current</link>           (<link linkend="gint32">gint32</link> image_ID);
  25. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-set-current">gimp_path_set_current</link>           (<link linkend="gint32">gint32</link> image_ID,
  26.                                              <link linkend="gchar">gchar</link> *set_current_path_name);
  27. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-set-points">gimp_path_set_points</link>            (<link linkend="gint32">gint32</link> image_ID,
  28.                                              <link linkend="gchar">gchar</link> *pathname,
  29.                                              <link linkend="gint">gint</link> ptype,
  30.                                              <link linkend="gint">gint</link> num_path_points,
  31.                                              <link linkend="gdouble">gdouble</link> *points_pairs);
  32. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-stroke-current">gimp_path_stroke_current</link>        (<link linkend="gint32">gint32</link> image_ID);
  33. <link linkend="gint">gint</link>        <link linkend="gimp-path-get-point-at-dist">gimp_path_get_point_at_dist</link>     (<link linkend="gint32">gint32</link> image_ID,
  34.                                              <link linkend="gdouble">gdouble</link> distance,
  35.                                              <link linkend="gint">gint</link> *y_point,
  36.                                              <link linkend="gdouble">gdouble</link> *gradient);
  37. <link linkend="gint">gint</link>        <link linkend="gimp-path-get-tattoo">gimp_path_get_tattoo</link>            (<link linkend="gint32">gint32</link> image_ID,
  38.                                              <link linkend="gchar">gchar</link> *pathname);
  39. <link linkend="gchar">gchar</link>*      <link linkend="gimp-get-path-by-tattoo">gimp_get_path_by_tattoo</link>         (<link linkend="gint32">gint32</link> image_ID,
  40.                                              <link linkend="gint">gint</link> tattoo);
  41. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-delete">gimp_path_delete</link>                (<link linkend="gint32">gint32</link> image_ID,
  42.                                              <link linkend="gchar">gchar</link> *path_name_to_del);
  43. <link linkend="gint">gint</link>        <link linkend="gimp-path-get-locked">gimp_path_get_locked</link>            (<link linkend="gint32">gint32</link> image_ID,
  44.                                              <link linkend="gchar">gchar</link> *pathname);
  45. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-set-locked">gimp_path_set_locked</link>            (<link linkend="gint32">gint32</link> image_ID,
  46.                                              <link linkend="gchar">gchar</link> *pathname,
  47.                                              <link linkend="gint">gint</link> lockstatus);
  48. <link linkend="gboolean">gboolean</link>    <link linkend="gimp-path-set-tattoo">gimp_path_set_tattoo</link>            (<link linkend="gint32">gint32</link> image_ID,
  49.                                              <link linkend="gchar">gchar</link> *pathname,
  50.                                              <link linkend="gint">gint</link> tattovalue);
  51. </synopsis>
  52. </refsynopsisdiv>
  53.  
  54.  
  55.  
  56.  
  57.  
  58. <refsect1>
  59. <title>Description</title>
  60. <para>
  61.  
  62. </para>
  63. </refsect1>
  64.  
  65. <refsect1>
  66. <title>Details</title>
  67. <refsect2>
  68. <title><anchor id="gimp-path-list">gimp_path_list ()</title>
  69. <programlisting><link linkend="gchar">gchar</link>**     gimp_path_list                  (<link linkend="gint32">gint32</link> image_ID,
  70.                                              <link linkend="gint">gint</link> *num_paths);</programlisting>
  71. <para>
  72. List the paths associated with the passed image.
  73. </para>
  74. <para>
  75. List the paths associated with the passed image.</para>
  76. <para>
  77.  
  78. </para><informaltable pgwide=1 frame="none" role="params">
  79. <tgroup cols="2">
  80. <colspec colwidth="2*">
  81. <colspec colwidth="8*">
  82. <tbody>
  83. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  84. <entry> The ID of the image to list the paths from.
  85. </entry></row>
  86. <row><entry align="right"><parameter>num_paths</parameter> :</entry>
  87. <entry> The number of paths returned.
  88. </entry></row>
  89. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> List of the paths belonging to this image.
  90. </entry></row>
  91. </tbody></tgroup></informaltable></refsect2>
  92. <refsect2>
  93. <title><anchor id="gimp-path-get-points">gimp_path_get_points ()</title>
  94. <programlisting><link linkend="gint">gint</link>        gimp_path_get_points            (<link linkend="gint32">gint32</link> image_ID,
  95.                                              <link linkend="gchar">gchar</link> *pathname,
  96.                                              <link linkend="gint">gint</link> *path_closed,
  97.                                              <link linkend="gint">gint</link> *num_path_point_details,
  98.                                              <link linkend="gdouble">gdouble</link> **points_pairs);</programlisting>
  99. <para>
  100. List the points associated with the named path.
  101. </para>
  102. <para>
  103. List the points associated with the named path.</para>
  104. <para>
  105.  
  106. </para><informaltable pgwide=1 frame="none" role="params">
  107. <tgroup cols="2">
  108. <colspec colwidth="2*">
  109. <colspec colwidth="8*">
  110. <tbody>
  111. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  112. <entry> The ID of the image to list the paths from.
  113. </entry></row>
  114. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  115. <entry> the name of the path whose points should be listed.
  116. </entry></row>
  117. <row><entry align="right"><parameter>path_closed</parameter> :</entry>
  118. <entry> Return if the path is closed. {0=path open, 1= path closed}.
  119. </entry></row>
  120. <row><entry align="right"><parameter>num_path_point_details</parameter> :</entry>
  121. <entry> The number of points returned. Each point is made up of (x,y,pnt_type) of floats.
  122. </entry></row>
  123. <row><entry align="right"><parameter>points_pairs</parameter> :</entry>
  124. <entry> The points in the path represented as 3 floats. The first is the x pos, next is the y pos, last is the type of the pnt. The type field is dependant on the path type. For beziers (type 1 paths) the type can either be {1.0= BEZIER_ANCHOR, 2.0= BEZIER_CONTROL}. Note all points are returned in pixel resolution.
  125. </entry></row>
  126. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The type of the path. Currently only one type (1 = Bezier) is supported.
  127. </entry></row>
  128. </tbody></tgroup></informaltable></refsect2>
  129. <refsect2>
  130. <title><anchor id="gimp-path-get-current">gimp_path_get_current ()</title>
  131. <programlisting><link linkend="gchar">gchar</link>*      gimp_path_get_current           (<link linkend="gint32">gint32</link> image_ID);</programlisting>
  132. <para>
  133. The name of the current path. Error if no paths.
  134. </para>
  135. <para>
  136. The name of the current path. Error if no paths.</para>
  137. <para>
  138.  
  139. </para><informaltable pgwide=1 frame="none" role="params">
  140. <tgroup cols="2">
  141. <colspec colwidth="2*">
  142. <colspec colwidth="8*">
  143. <tbody>
  144. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  145. <entry> The ID of the image to get the current paths from.
  146. </entry></row>
  147. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The name of the current path.
  148. </entry></row>
  149. </tbody></tgroup></informaltable></refsect2>
  150. <refsect2>
  151. <title><anchor id="gimp-path-set-current">gimp_path_set_current ()</title>
  152. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_set_current           (<link linkend="gint32">gint32</link> image_ID,
  153.                                              <link linkend="gchar">gchar</link> *set_current_path_name);</programlisting>
  154. <para>
  155. List the paths associated with the passed image.
  156. </para>
  157. <para>
  158. List the paths associated with the passed image.</para>
  159. <para>
  160.  
  161. </para><informaltable pgwide=1 frame="none" role="params">
  162. <tgroup cols="2">
  163. <colspec colwidth="2*">
  164. <colspec colwidth="8*">
  165. <tbody>
  166. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  167. <entry> The ID of the image to list set the paths in.
  168. </entry></row>
  169. <row><entry align="right"><parameter>set_current_path_name</parameter> :</entry>
  170. <entry> The name of the path to set the current path to.
  171. </entry></row>
  172. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  173. </entry></row>
  174. </tbody></tgroup></informaltable></refsect2>
  175. <refsect2>
  176. <title><anchor id="gimp-path-set-points">gimp_path_set_points ()</title>
  177. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_set_points            (<link linkend="gint32">gint32</link> image_ID,
  178.                                              <link linkend="gchar">gchar</link> *pathname,
  179.                                              <link linkend="gint">gint</link> ptype,
  180.                                              <link linkend="gint">gint</link> num_path_points,
  181.                                              <link linkend="gdouble">gdouble</link> *points_pairs);</programlisting>
  182. <para>
  183. Set the points associated with the named path.
  184. </para>
  185. <para>
  186. Set the points associated with the named path.</para>
  187. <para>
  188.  
  189. </para><informaltable pgwide=1 frame="none" role="params">
  190. <tgroup cols="2">
  191. <colspec colwidth="2*">
  192. <colspec colwidth="8*">
  193. <tbody>
  194. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  195. <entry> The ID of the image to set the paths in.
  196. </entry></row>
  197. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  198. <entry> The name of the path to create (if it exists then a unique name will be created - query the list of paths if you want to make sure that the name of the path you create is unique. This will be set as the current path.
  199. </entry></row>
  200. <row><entry align="right"><parameter>ptype</parameter> :</entry>
  201. <entry> The type of the path. Currently only one type (1 = Bezier) is supported.
  202. </entry></row>
  203. <row><entry align="right"><parameter>num_path_points</parameter> :</entry>
  204. <entry> The number of points in the path. Each point is made up of (x,y,type) of floats. Currently only the creation of bezier curves is allowed. The type parameter must be set to (1) to indicate a BEZIER type curve. For BEZIERS. Note the that points must be given in the following order... ACCACCAC ... If the path is not closed the last control point is missed off. Points consist of three control points (control/anchor/control) so for a curve that is not closed there must be at least two points passed (2 x,y pairs). If num_path_pnts % 3 = 0 then the path is assumed to be closed and the points are ACCACCACCACC.
  205. </entry></row>
  206. <row><entry align="right"><parameter>points_pairs</parameter> :</entry>
  207. <entry> The points in the path represented as 3 floats. The first is the x pos, next is the y pos, last is the type of the pnt. The type field is dependant on the path type. For beziers (type 1 paths) the type can either be {1.0= BEZIER_ANCHOR, 2.0= BEZIER_CONTROL}. Note all points are returned in pixel resolution.
  208. </entry></row>
  209. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  210. </entry></row>
  211. </tbody></tgroup></informaltable></refsect2>
  212. <refsect2>
  213. <title><anchor id="gimp-path-stroke-current">gimp_path_stroke_current ()</title>
  214. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_stroke_current        (<link linkend="gint32">gint32</link> image_ID);</programlisting>
  215. <para>
  216. Stroke the current path in the passed image.
  217. </para>
  218. <para>
  219. Stroke the current path in the passed image.</para>
  220. <para>
  221.  
  222. </para><informaltable pgwide=1 frame="none" role="params">
  223. <tgroup cols="2">
  224. <colspec colwidth="2*">
  225. <colspec colwidth="8*">
  226. <tbody>
  227. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  228. <entry> The ID of the image which contains the path to stroke.
  229. </entry></row>
  230. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  231. </entry></row>
  232. </tbody></tgroup></informaltable></refsect2>
  233. <refsect2>
  234. <title><anchor id="gimp-path-get-point-at-dist">gimp_path_get_point_at_dist ()</title>
  235. <programlisting><link linkend="gint">gint</link>        gimp_path_get_point_at_dist     (<link linkend="gint32">gint32</link> image_ID,
  236.                                              <link linkend="gdouble">gdouble</link> distance,
  237.                                              <link linkend="gint">gint</link> *y_point,
  238.                                              <link linkend="gdouble">gdouble</link> *gradient);</programlisting>
  239. <para>
  240. Get point on a path at a specified distance along the path.
  241. </para>
  242. <para>
  243. This will return the x,y position of a point at a given distance
  244. along the bezier curve. The distance will the obtained by first
  245. digitizing the curve internally an then walking along the curve. For
  246. a closed curve the start of the path is the first point on the path
  247. that was created. This might not be obvious. Note the current path
  248. is used.</para>
  249. <para>
  250.  
  251. </para><informaltable pgwide=1 frame="none" role="params">
  252. <tgroup cols="2">
  253. <colspec colwidth="2*">
  254. <colspec colwidth="8*">
  255. <tbody>
  256. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  257. <entry> The ID of the image the paths belongs to.
  258. </entry></row>
  259. <row><entry align="right"><parameter>distance</parameter> :</entry>
  260. <entry> The distance along the path.
  261. </entry></row>
  262. <row><entry align="right"><parameter>y_point</parameter> :</entry>
  263. <entry> The y position of the point.
  264. </entry></row>
  265. <row><entry align="right"><parameter>gradient</parameter> :</entry>
  266. <entry> The gradient at the specified point.
  267. </entry></row>
  268. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The x position of the point.
  269. </entry></row>
  270. </tbody></tgroup></informaltable></refsect2>
  271. <refsect2>
  272. <title><anchor id="gimp-path-get-tattoo">gimp_path_get_tattoo ()</title>
  273. <programlisting><link linkend="gint">gint</link>        gimp_path_get_tattoo            (<link linkend="gint32">gint32</link> image_ID,
  274.                                              <link linkend="gchar">gchar</link> *pathname);</programlisting>
  275. <para>
  276. Returns the tattoo associated with the name path.
  277. </para>
  278. <para>
  279. This procedure returns the tattoo associated with the specified
  280. path. A tattoo is a unique and permanent identifier attached to a
  281. path that can be used to uniquely identify a path within an image
  282. even between sessions.</para>
  283. <para>
  284.  
  285. </para><informaltable pgwide=1 frame="none" role="params">
  286. <tgroup cols="2">
  287. <colspec colwidth="2*">
  288. <colspec colwidth="8*">
  289. <tbody>
  290. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  291. <entry> The image.
  292. </entry></row>
  293. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  294. <entry> the name of the path whose tattoo should be obtained.
  295. </entry></row>
  296. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The tattoo associated with the name path.
  297. </entry></row>
  298. </tbody></tgroup></informaltable></refsect2>
  299. <refsect2>
  300. <title><anchor id="gimp-get-path-by-tattoo">gimp_get_path_by_tattoo ()</title>
  301. <programlisting><link linkend="gchar">gchar</link>*      gimp_get_path_by_tattoo         (<link linkend="gint32">gint32</link> image_ID,
  302.                                              <link linkend="gint">gint</link> tattoo);</programlisting>
  303. <para>
  304. Return the name of the path with the given tattoo.
  305. </para>
  306. <para>
  307. The procedure returns the name of the path in the specified image
  308. which has the passed tattoo. The tattoos are unique within the image
  309. and will be preserved across sessions and through renaming of the
  310. path. An error is returned if no path woth the specified tattoo can
  311. be found.</para>
  312. <para>
  313.  
  314. </para><informaltable pgwide=1 frame="none" role="params">
  315. <tgroup cols="2">
  316. <colspec colwidth="2*">
  317. <colspec colwidth="8*">
  318. <tbody>
  319. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  320. <entry> The image.
  321. </entry></row>
  322. <row><entry align="right"><parameter>tattoo</parameter> :</entry>
  323. <entry> The tattoo of the required path.
  324. </entry></row>
  325. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The name of the path with the specified tattoo.
  326. </entry></row>
  327. </tbody></tgroup></informaltable></refsect2>
  328. <refsect2>
  329. <title><anchor id="gimp-path-delete">gimp_path_delete ()</title>
  330. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_delete                (<link linkend="gint32">gint32</link> image_ID,
  331.                                              <link linkend="gchar">gchar</link> *path_name_to_del);</programlisting>
  332. <para>
  333. Delete the named paths associated with the passed image.
  334. </para>
  335. <para>
  336. Delete the named path.</para>
  337. <para>
  338.  
  339. </para><informaltable pgwide=1 frame="none" role="params">
  340. <tgroup cols="2">
  341. <colspec colwidth="2*">
  342. <colspec colwidth="8*">
  343. <tbody>
  344. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  345. <entry> The ID of the image to list delete the paths from.
  346. </entry></row>
  347. <row><entry align="right"><parameter>path_name_to_del</parameter> :</entry>
  348. <entry> The name of the path to delete.
  349. </entry></row>
  350. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  351. </entry></row>
  352. </tbody></tgroup></informaltable></refsect2>
  353. <refsect2>
  354. <title><anchor id="gimp-path-get-locked">gimp_path_get_locked ()</title>
  355. <programlisting><link linkend="gint">gint</link>        gimp_path_get_locked            (<link linkend="gint32">gint32</link> image_ID,
  356.                                              <link linkend="gchar">gchar</link> *pathname);</programlisting>
  357. <para>
  358. Returns the locked status associated with the name path.
  359. </para>
  360. <para>
  361. This procedure returns the lock status associated with the specified
  362. path. A path can be \"locked\" which means that the transformation
  363. tool operations will also apply to the path.</para>
  364. <para>
  365.  
  366. </para><informaltable pgwide=1 frame="none" role="params">
  367. <tgroup cols="2">
  368. <colspec colwidth="2*">
  369. <colspec colwidth="8*">
  370. <tbody>
  371. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  372. <entry> The image.
  373. </entry></row>
  374. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  375. <entry> the name of the path whose locked status should be obtained.
  376. </entry></row>
  377. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The lock status associated with the name path. 0 returned if the path is not locked. 1 is returned if the path is locked.
  378. </entry></row>
  379. </tbody></tgroup></informaltable></refsect2>
  380. <refsect2>
  381. <title><anchor id="gimp-path-set-locked">gimp_path_set_locked ()</title>
  382. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_set_locked            (<link linkend="gint32">gint32</link> image_ID,
  383.                                              <link linkend="gchar">gchar</link> *pathname,
  384.                                              <link linkend="gint">gint</link> lockstatus);</programlisting>
  385. <para>
  386. Set the locked status associated with the name path.
  387. </para>
  388. <para>
  389. This procedure sets the lock status associated with the specified
  390. path. A path can be \"locked\" which means that the transformation
  391. tool operations will also apply to the path.</para>
  392. <para>
  393.  
  394. </para><informaltable pgwide=1 frame="none" role="params">
  395. <tgroup cols="2">
  396. <colspec colwidth="2*">
  397. <colspec colwidth="8*">
  398. <tbody>
  399. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  400. <entry> The image.
  401. </entry></row>
  402. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  403. <entry> the name of the path whose locked status should be set.
  404. </entry></row>
  405. <row><entry align="right"><parameter>lockstatus</parameter> :</entry>
  406. <entry> The lock status associated with the name path. 0 if the path is not locked. 1 if the path is to be locked.
  407. </entry></row>
  408. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  409. </entry></row>
  410. </tbody></tgroup></informaltable></refsect2>
  411. <refsect2>
  412. <title><anchor id="gimp-path-set-tattoo">gimp_path_set_tattoo ()</title>
  413. <programlisting><link linkend="gboolean">gboolean</link>    gimp_path_set_tattoo            (<link linkend="gint32">gint32</link> image_ID,
  414.                                              <link linkend="gchar">gchar</link> *pathname,
  415.                                              <link linkend="gint">gint</link> tattovalue);</programlisting>
  416. <para>
  417. Sets the tattoo associated with the name path.
  418. </para>
  419. <para>
  420. This procedure sets the tattoo associated with the specified path. A
  421. tattoo is a unique and permenant identifier attached to a path that
  422. can be used to uniquely identify a path within an image even between
  423. sessions. Note that the value passed to this function must have been
  424. obtained from a previous call to path_get_tattoo.</para>
  425. <para>
  426.  
  427. </para><informaltable pgwide=1 frame="none" role="params">
  428. <tgroup cols="2">
  429. <colspec colwidth="2*">
  430. <colspec colwidth="8*">
  431. <tbody>
  432. <row><entry align="right"><parameter>image_ID</parameter> :</entry>
  433. <entry> The image.
  434. </entry></row>
  435. <row><entry align="right"><parameter>pathname</parameter> :</entry>
  436. <entry> the name of the path whose tattoo should be set.
  437. </entry></row>
  438. <row><entry align="right"><parameter>tattovalue</parameter> :</entry>
  439. <entry> The tattoo associated with the name path. Only values returned from 'path_get_tattoo' should be used here.
  440. </entry></row>
  441. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
  442. </entry></row>
  443. </tbody></tgroup></informaltable></refsect2>
  444.  
  445. </refsect1>
  446.  
  447.  
  448.  
  449.  
  450. </refentry>
  451.